package com.xiuxia.bopicturebackend.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.xiuxia.bopicturebackend.api.aliyunai.model.CreateOutPaintingTaskResponse;
import com.xiuxia.bopicturebackend.model.dto.picture.*;
import com.xiuxia.bopicturebackend.model.entity.Picture;
import com.xiuxia.bopicturebackend.model.entity.User;
import com.xiuxia.bopicturebackend.model.vo.picture.PictureVO;

import javax.servlet.http.HttpServletRequest;
import java.util.List;

/**
* @author 17732
* @description 针对表【picture(图片)】的数据库操作Service
* @createDate 2025-04-29 22:16:56
*/
public interface PictureService extends IService<Picture> {
    /**
     * 校验图片信息
     * @param picture 图片
     */
    void validPicture(Picture picture);

    /**
     * 上传图片
     *
     * @param inputSource 文件输入源
     * @param pictureUploadRequestDTO 图片上传请求体
     * @param loginUser 登录用户
     * @return
     */
    PictureVO uploadPicture(Object inputSource,
                            PictureUploadRequestDTO pictureUploadRequestDTO,
                            User loginUser);

    /**
     * 获取图片包装类（单条）
     * @param picture 原始图片信息
     * @param request 请求
     * @return 包装后的图片信息
     */
    PictureVO getPictureVO(Picture picture, HttpServletRequest request);
    /**
     * 获取图片包装类（多条）
     * @param picturePage 原始图片分页信息
     * @param request 请求
     * @return 包装后的图片分页信息
     */
    Page<PictureVO> getPictureVOPage(Page<Picture> picturePage, HttpServletRequest request);

    /**
     * 获取查询对象
     * @param pictureQueryRequest 查询条件
     * @return 查询对象
     */
    QueryWrapper<Picture> getQueryWrapper(PictureQueryRequestDTO pictureQueryRequest);

    /**
     * 图片审核
     *
     * @param pictureReviewRequestDTO 图片审核请求体
     * @param loginUser               登录用户
     */
    void doPictureReview(PictureReviewRequestDTO pictureReviewRequestDTO, User loginUser);

    /**
     * 填充审核参数
     *
     * @param picture 图片
     * @param loginUser 登录用户
     */
    void fillPictureParam(Picture picture, User loginUser);

    /**
     * 管理员批量抓取图片
     *
     * @param pictureUploadByBatchRequestDTO 图片上传批量请求体
     * @param loginUser                      登录用户
     * @return 图片数量
     */
    Integer pictureUploadByBatch(PictureUploadByBatchRequestDTO pictureUploadByBatchRequestDTO, User loginUser);

    /**
     * 清理图片文件（对象存储中的图片文件）
     * @param oldPicture
     */
    void clearPictureFile(Picture oldPicture);

    /**
     * 获取所有被删除的图片
     * @return 图片列表
     */
    List<Picture> getDeletedPictureList();

    /**
     * 删除图片（
     * @param pictureId 图片id
     * @param loginUser 登录用户
     * @return 是否成功
     */
    Boolean deletePicture(Long pictureId, User loginUser);

    /**
     * 检查图片操作权限
     * @param loginUser 登录用户
     * @param picture  图片
     */
    void checkPictureAuth(User loginUser, Picture picture);

    /**
     * 编辑图片
     * @param pictureEditRequest 图片编辑请求体
     * @param request 请求
     */
    void editPicture(PictureEditRequestDTO pictureEditRequest, HttpServletRequest request);

    /**
     * 图片颜色搜索
     * @param spaceId 空间id
     * @param picColor 颜色
     * @param loginUser 登录用户
     * @return 图片列表
     */
    List<PictureVO> searchPictureByColor(Long spaceId, String picColor,User loginUser);

    /**
     * 批量编辑图片
     * @param pictureEditByBatchRequestDTO 图片批量编辑请求体
     * @param loginUser 登录用户
     */
    void batchEditPicture(PictureEditByBatchRequestDTO pictureEditByBatchRequestDTO, User loginUser);

    /**
     * 批量删除图片
     * @param deleteRequest 图片批量删除请求体
     * @param request 请求
     */
    void deletePictureByBatch(PictureDeleteByBatchRequestDTO deleteRequest, HttpServletRequest request);

    /**
     * 创建图片ai扩图任务
     * @param createPictureOutPaintingTaskRequest 图片ai扩图任务请求体
     * @param loginUser 登录用户
     * @return 图片ai扩图任务响应体
     */
    CreateOutPaintingTaskResponse createPictureOutPaintingTask(CreatePictureOutPaintingTaskRequest createPictureOutPaintingTaskRequest, User loginUser);
}
